home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat2 / standard / chroot.z / chroot
Encoding:
Text File  |  1998-10-20  |  4.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4. cccchhhhrrrrooooooootttt((((2222))))                                                            cccchhhhrrrrooooooootttt((((2222))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _cccc_hhhh_rrrr_oooo_oooo_tttt - change root directory
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_uuuu_nnnn_iiii_ssss_tttt_dddd_...._hhhh_>>>>
  13.  
  14.      _iiii_nnnn_tttt _cccc_hhhh_rrrr_oooo_oooo_tttt_((((_cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_pppp_aaaa_tttt_hhhh_))))_;;;;
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      _p_a_t_h points to a path name naming a directory.  _cccc_hhhh_rrrr_oooo_oooo_tttt causes the named
  18.      directory to become the root directory, the starting point for path
  19.      searches for path names beginning with _////.  The user's working directory
  20.      is unaffected by the _cccc_hhhh_rrrr_oooo_oooo_tttt system call.
  21.  
  22.      The calling process must have the super-user privilege to change the root
  23.      directory.
  24.  
  25.      The _...._....  entry in the root directory is interpreted to mean the root
  26.      directory itself.  Thus, _...._....  cannot be used to access files outside the
  27.      subtree rooted at the root directory.
  28.  
  29.      _cccc_hhhh_rrrr_oooo_oooo_tttt will fail and the root directory will remain unchanged if one or
  30.      more of the following are true:
  31.  
  32.      _EEEE_AAAA_CCCC_CCCC_EEEE_SSSS         Search permission is denied on a component of the
  33.                     pathname.
  34.  
  35.      _EEEE_LLLL_OOOO_OOOO_PPPP          Too many symbolic links were encountered in translating
  36.                     _p_a_t_h.
  37.  
  38.      _EEEE_NNNN_AAAA_MMMM_EEEE_TTTT_OOOO_OOOO_LLLL_OOOO_NNNN_GGGG   The length of the _p_a_t_h argument exceeds {_PPPP_AAAA_TTTT_HHHH______MMMM_AAAA_XXXX}, or the
  39.                     length of a _p_a_t_h component exceeds {_NNNN_AAAA_MMMM_EEEE______MMMM_AAAA_XXXX} while
  40.                     ______PPPP_OOOO_SSSS_IIII_XXXX______NNNN_OOOO______TTTT_RRRR_UUUU_NNNN_CCCC is in effect.
  41.  
  42.      _EEEE_FFFF_AAAA_UUUU_LLLL_TTTT         _p_a_t_h points outside the allocated address space of the
  43.                     process.
  44.  
  45.      _EEEE_IIII_NNNN_TTTT_RRRR          A signal was caught during the _cccc_hhhh_rrrr_oooo_oooo_tttt system call.
  46.  
  47.      _EEEE_MMMM_UUUU_LLLL_TTTT_IIII_HHHH_OOOO_PPPP      Components of _p_a_t_h require hopping to multiple remote
  48.                     machines and file system type does not allow it.
  49.  
  50.      _EEEE_NNNN_OOOO_LLLL_IIII_NNNN_KKKK        _p_a_t_h points to a remote machine and the link to that
  51.                     machine is no longer active.
  52.  
  53.      _EEEE_TTTT_IIII_MMMM_EEEE_DDDD_OOOO_UUUU_TTTT      The named directory is located on a remote file system
  54.                     which is not available [see _iiii_nnnn_tttt_rrrr_oooo(2)].
  55.  
  56.      _EEEE_NNNN_OOOO_TTTT_DDDD_IIII_RRRR        Any component of the path name is not a directory.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. cccchhhhrrrrooooooootttt((((2222))))                                                            cccchhhhrrrrooooooootttt((((2222))))
  71.  
  72.  
  73.  
  74.      _EEEE_NNNN_OOOO_EEEE_NNNN_TTTT         The named directory does not exist or is a null pathname.
  75.  
  76.      _EEEE_PPPP_EEEE_RRRR_MMMM          The calling process does not have the super-user privilege
  77.                     for changing the root directory.
  78.  
  79. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  80.      _cccc_hhhh_dddd_iiii_rrrr(2).
  81.  
  82. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  83.      Upon successful completion, a value of 0 is returned.  Otherwise, a value
  84.      of -1 is returned and _eeee_rrrr_rrrr_nnnn_oooo is set to indicate the error.
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.